Changing the MAGIC Subsystem Configuration (Magic xpa 3.x)
The Magic xpa server is set to run in the MAGIC subsystem. To change the MAGIC Subsystem configuration:
-
Select the Magic Config. menu option.
-
Select Option 5, MAGIC Subsystem Config., to bring up the MAGIC Subsystem Confg. screen.
At this stage, JOBQ MGSERVER and a routing entry for the MGSERVER job are added to a selected subsystem description.
MGSERVER JOBQ is a default JOBQ of the server jobs. When you start a server job using STRMGCXPA, STRMAGRUN or STRMAGINST, the job is submitted to JOBQ MGSERVER. The routing entry sets a job class and a memory pool of the system main storage where the MGSERVER job is going to run. By default, it is set to MGSERVER job class and storage pool 1.
The following job properties are controlled by the job class: Run priority, Time slice in milliseconds, Eligible for purge, Default wait time in seconds, Maximum CPU time in milliseconds, Maximum temporary storage in megabytes, and Maximum threads. You can manually change them during the job performance tuning by using the CHGCLS IBM i command. For example: CHGCLS CLS(<Magic install directory>/MGSERVER) RUNPTY(XX) TIMESLICE(XXXX) CPUTIME(*NOMAX) MAXTMPSTG(*NOMAX) MAXTHD(*NOMAX).
The routing entry is linked with a job description via the Compare value property of the routing entry and the Routing Data property of the job description. When the MGSERVER job enters the subsystem via JOBQ, the system validates the Routing Data of the job description against the Compare value of the routing entries in the subsystem. When the match is found, the job’s memory pool is assigned and the relevant job properties are applied to the job according to the routing entry settings.
Make sure that the server subsystem is not active when you configure it via the menu. For security reasons, this step is allowed only when the subsystem is not active. Make sure that you do not have jobs pending in the job queue.
As an alternative to the configuration menu, you can use the IBM i ADDJOBQE or RMVJOBQE and ADDRTGE or RMVRTGE commands for Magic xpa server configuration:
-
Connect JOBQ to subsystem:
ADDJOBQE SBSD(SBSLIB/SBSNAME) JOBQ(<Magic install directory>/MGSERVER) MAXACT(5) SEQNBR(10)
Where:
SBSLIB – name of the subsystem library
SBSNAME – subsystem name
<Magic install directory> – name of the server installation
5 – maximum number of concurrently active jobs
10 – job sequence number in subsystem property. The next available number can be found using the WRKSBSD command:
WRKSBSD SBSLIB/SBSNAME
option 5 (Display)
option 6 (Display Job Queue Entries)
-
Disconnect JOBQ from Subsystem:
RMVJOBQE SBSD(SBSLIB/SBSNAME) JOBQ([Magic install directory]/MGSERVER)
-
Add Routing entry:
ADDRTGE SBSD(SVRLIB/SBSNAME) SEQNBR(10) CMPVAL(MAGICXPA24.MGRNT) PGM(QCMD) CLS(SVRLIB/MGSERVER)
-
Remove Routing entry:
RMVRTGE SBSD(SVRLIB/SBSNAME) SEQNBR(10)
-
If there's an error, verify the joblog using the DSPJOB option 10.
Broker Subsystem Configuration
