DEFINE-JOB-STREAM - Write stream definitions to SJMSFILE

This statement writes a new stream definition to the SJMSFILE file or the JMS database.

Format

DEFINE-JOB-STREAM                                                                                                                                           

NAME = <name 1..8>
,FILE = <filename 1..54> / *LIBRARY-ELEMENT(...)
	*LIBRARY-ELEMENT(...)
		|	LIBRARY = <filename 1..41>
		|	,ELEMENT = <name 1..8>
,RUN-PRIORITY = 65 / <integer 30..255>
,DEFAULT = *NO / *YES
,START = *AT-LOAD / *BY-OPERATOR / *AT(...) / *EARLIEST(...)
	*AT(...)
		|	TIME = <time 1..8>
	*EARLIEST(...)
		|	TIME = <time 1..8>
,STOP = *AT-SHUTDOWN / *BY-OPERATOR / *AT(...) / *AFTER(...)
	*AT(...)
		|	TIME = 00:00 / <time 1..8>
	*AFTER(...)
		|	HOURS = 00 / <integer 0..23>
		|	,MINUTES = 00 / <integer 0..59>
,STREAM-PARAMETER = *NO / <c-string 1..127>

Operands

NAME = <name 1..8>
Name of the stream definition to be written to SJMSFILE. A string of between 1 and 8 alphanumeric characters may be specified, starting with the character A-Z, @ or #.

FILE = <filename 1..54>
Name of the ENTER file containing the job that is initiated during the stream start and that activates the job scheduler.
The job scheduler can only process batch jobs.

FILE = *LIBRARY-ELEMENT(...)

LIBRARY = <filename 1..41>
File name of the library.

ELEMENT = <name 1..8>
The library element containing the ENTER file named above.

RUN-PRIORITY = 65 / <integer 30..255>
Specifies the starting priority to be assigned to the stream task under which the job scheduler runs.

DEFAULT = *NO / *YES
Specifies whether the stream involved is to be the default stream for the system.
YES means the stream is to be the default stream for those job classes that have specified that they wish to use the default stream.

START =
Specifies when the stream is to be started.

START = *AT-LOAD
The stream is to be started automatically when the system is loaded.

START = *BY-OPERATOR
The stream must be started by the operator or system administration using /START-JOB-STREAM.

START = *AT(...)
The stream is to be started automatically during each session at the specified time. If a session is started after the specified time, the stream can be started only within the next 30 minutes after the time specified. A start at a later point within the current session is not possible.

If the job stream is to be entered in the JMS database, the following applies: The stream is started when the START time is not exceeded by more than 5 minutes and the STOP time has not yet been reached.

START = *EARLIEST(...)
The stream is to be started at the earliest at the specified time during each session. If the system is not active at the time specified, the start is retried until a specified STOP time or until 24:00 hours.

If the job stream is to be entered in the JMS database, the following applies: The stream is started when the START time is exceeded and the STOP time has not yet been reached.

TIME = 00:00 / <time 1..8>
Time of day in the format hh:mm; i.e. hours and minutes only, seconds are ignored.

STOP =
Specifies when the stream is to be stopped.

STOP = *AT-SHUTDOWN
The stream is to be stopped when the system is shut down.

STOP = *BY-OPERATOR
The stream must be stopped by the operator or system administration by means of /STOP-JOB-STREAM.

 

STOP = *AT(...)
The stream is to be stopped automatically at the specified time (hh:mm see START=*AT...).

TIME = 00:00 / <time 1..8>
Time of day in the format hh:mm; i.e. hours and minutes only, seconds are ignored.

STOP = *AFTER(...)
The stream is to be stopped after the specified time has elapsed.

HOURS = 00 / <integer 0..23>
HOURS= between 0 and 23 hours may be specified.

MINUTES = 00 / <integer 0..59>
A value between 0 and 59 minutes may be given.

If for any reason the system is shut down during the time between system start and the time specified for stopping the stream, and the system is then restarted before the time the stream was to be stopped, the stream is also restarted automatically.

STREAM-PARAMETER =
This operand defines special scheduling parameters for the job scheduler in free syntax. The contents of this operand are not evaluated by the system.
However, the job scheduler involved must understand both the syntax and the meaning of STREAM-PARAMETER in order to be able to accept the scheduling parameters defined there.
The job scheduler gets this information via the job scheduler interface. The job scheduler interface provides, via a TU interface, functions required by the job scheduler to carry out its tasks (for further details, see “Introduction to System Administration” [5 (Related publications)]).

STREAM-PARAMETER = <c-string 1..127>
Sequence of special parameters for the job scheduler.
When the system is started up the information contained in the parameters is transferred to internal tables, where it can be accessed by the job scheduler.

The default job scheduler knows the following parameters:

S-PAR =  'JOB-PRIORITY = YES / NO

          ,CPU-TIME = NO / YES

          ,WAIT-TIME = NO / YES

          ,JOB-QUOTA = 1 / <integer 1..255>

          ,LOGGING = YES / NO

          ,CATID-LIST = (catid1,...)

          ,CAT-TIME = min

          ,MSG-OUTPUT = YES / STD'

STREAM-PARAMETER = *NO
Means that no special parameters are defined for the job scheduler.

 

Notes

• This statement is rejected if a stream with the specified name is already contained in the SJMSFILE.

• Only one default stream may exist in the system. An attempt to define more than one default stream will be rejected.

• No more than 16 streams may be defined.