Server Initialization (Magic xpa 3.x) – STRMGCXPA Command
STRMGCXPA is the only supported interface for starting Magic xpa server engines on the IBM i.
The STRMGCXPA command enables the starting of server engines with the following initialization parameters:
|
|
|
|
StartApplication
|
*INI, Path
|
Char 256
|
Project path
|
Environment File
|
*DFT, Path
|
Char 256
|
Path of the environment file (MGENV400)
|
INI File
|
*DFT, Path
|
Char 256
|
Path of the ini file
|
INI Modification (@) File Path
|
*NONE, Path
|
Char 256
|
Path of the @ file
|
Activate Requests Server
|
*Yes/*No
|
Char 4
|
Connect to broker
|
Server Instances to Start
|
Number 1 - 999
|
Dec 3
|
Number of engines to start
|
Log File Path:
Name
Directory
|
|
|
Path of the log file. No path validation is required.
|
ANSI CCSID
|
*DFT, Name
|
Char 5
|
Code Page of the IFS files
|
EBCDIC CCSID
|
*DFT, Name
|
Char 5
|
PASE CCSID
|
User Parameters
|
*NONE
|
Char 500
|
User string. This string is forwarded to the SBMSVRJOB CL program where it can be parsed and used for defining parameters of the SBMJOB, such as JOBNAME and *JOBQ.
Note: To send a parameter that contains blanks, surround the string with double quotes if you want to retain the blanks. For example: -PARM="1 2 3 4 5".
|
Additional Parameters:
20 sets of three parameters
|
|
|
|
INI Section
|
Name
|
Char 50
|
Name of the ini section
|
INI Entry
|
Name
|
Char 50
|
Name of the ini entry
|
Value
|
Name
|
Char 256
|
Value of the entry
|
Load JVM
|
*Yes/*No
|
Char 4
|
Load Java VM during initialization of the server instance.
Since version: 1.9g
|
Wait for Server Messages
|
*Yes/*No
|
Char 4
|
Wait for Server job to start. When it is set to *Yes, the calling job waits for the Magic xpa server job to start and registers the job number in the Message Queue.
Since version: 2.3
|