Start Mail Server Framework (STRMSF)

Where allowed to run: All environments (*ALL)
Threadsafe: No
Parameters
Examples
Error messages

The Start Mail Server Framework (STRMSF) command starts the mail server framework jobs in the system work subsystem (QSYSWRK).

Top

Parameters

Keyword Description Choices Notes
MSGOPT How to process mail messages *RESUME, *RESET, *CLEAR Optional, Positional 1
NBRMSFJOB Number of MSF jobs 1-99, 3 Optional, Positional 2
Top

How to process mail messages (MSGOPT)

Specifies how the mail server framework processes existing mail server framework messages.

The possible values are:

*RESUME
All existing mail server framework messages continue processing from the point the mail server framework previously ended.
*RESET
All existing mail server framework messages are processed as if they were just created.
*CLEAR
All existing mail server framework messages are deleted. This option should only be used when a software error is reported with the mail server framework or its associated exit point programs.
Top

Number of MSF jobs (NBRMSFJOB)

Specifies the number of mail server framework jobs to start. This option allows concurrent processing of several mail server framework messages.

The possible values are:

3
Three jobs are started.
number-of-jobs
Specify the number of jobs you want handling mail server framework messages. The valid values range from 1 through 99.
Top

Examples

Example 1: Starting One Mail Server Framework Job

STRMSF   NBRMSFJOB(1)

This command starts one mail server framwork job in a normal manner, processing any mail server framework messages at the point at which processing was interrupted.

Example 2: Restarting Mail Server Framework Jobs

STRMSF   NBRMSFJOB(3)  MSGOPT(*RESET)

This command starts three mail server framework jobs and any mail server framework messages which were partially handled by previous mail server famework jobs are processed again from the beginning.

Top

Error messages

*ESCAPE Messages

CPFAFAA
STRMSF did not complete successfully.
CPFAFAD
Mail Server Framework currently active.
CPFAFA0
Errors detected on MSF internal message index.
CPFAFA1
Errors detected on MSF internal message queue.
CPFAFFF
Internal system error in program &1.
Top