Académique Documents
Professionnel Documents
Culture Documents
of the employees , a management system is a must which is a three module system administrator , consultant and leader where consultant is allotted a module and will update his manhours according to which leader will rate his performance and admin has the authority to add or remove the consultant or the leader. Moreover , admin can assign a consultant to a leader and give his remarks as well.
IBM Web Administration for i has several definitions depending on who you ask. From a user perspective, the IBM Web Administration for i provides an easy-to-use Web interface for configuring and managing Web technologies found on the IBM i platform. From an IBM i system administrator perspective, IBM Web Administration for i represents a Web application running in an IBM integrated Web application server associated with an IBM HTTP server acting as a front-end Web server. From an IBM i work management perspective, IBM Web Administration for i consists of one subsystem (QHTTPSVR), one job queue (QZHBHTTP), and multiple active jobs responsible for running and managing the various Web related servers defined within the IBM Web Administration for i interface on a system. This article will focus on IBM Web Administration for i from an IBM i system administrator and work management point of view. A better understanding of the jobs related to IBM Web Administration for i can prove to be very helpful while performing troubleshooting and problem determination of HTTP
related servers, the IBM Web Administration for i GUI, IBM Systems Director Navigator or other Webbased administration interfaces on IBM i.
13. WRKSBSJOB SBS(QHTTPSVR) Job User Type -----Status----ADMIN QTMHHTTP BATCH ACTIVE ADMIN QTMHHTTP BATCHI ACTIVE ADMIN QTMHHTTP BATCHI ACTIVE ADMIN QTMHHTTP BATCHI ACTIVE
14.
15. The HTTP server job showing function PGM-QZHBMAIN and running under user profile QTMHHTTP is the manager job for the ADMIN HTTP server. When you enter the aforementioned STRTCPSVR command, this job is the first job submitted to job queue QZHBHTTP in library QHTTPSVR. 16. As the manager job for the ADMIN HTTP server, this job initiates the startup of all the other ADMIN HTTP related jobs, such as the logging job, any CGI jobs, the primary job, and the hot backup job if the hot backup functionality is enabled.
17.
Logging Jobs
HTTP server jobs showing function PGM-QZSRLOG and running under user profile QTMHHTTP provide logging for the ADMIN HTTP server. Each logging job is responsible for logging to a single log. Error logs and access logs are two different types of log files that can be written to. Logging-related directives specified in the HTTP configuration file determine which logs need to be written to. In our example, error logging is turned on while access logging is turned off. Therefore, only a single logging job is active for the ADMIN HTTP server. The following sequence of steps can be followed in order to determine the name of the log file a specific logging job is responsible for. 1. Specify 5=Work with next to the logging job from the Work With Subsystem Jobs display. 2. Specify Option 10 and press Enter on the Work With Job display to view the logging job's joblog. 3. Place the cursor on message HTP8432 with text This is a logging job for HTTP server ADMIN. 4. Press F1=Help on the HTP8432 message to see the message details. The message's technical description text will state what log file this particular job is writing to. For the
ADMIN HTTP server, the error logging job writes to file: /QIBM/UserData/HTTPA/admin/logs/error_log.
Primary Job
The HTTP server job showing function PGM-QZSRHTTP and running under user profile QTMHHTTP is the primary job for the ADMIN HTTP server. This is the job with the largest number of threads and is responsible for actively handling incoming HTTP requests.
CGI Job
The job showing function PGM-QZSRCGI and running under user profile QTMHHTTP is a CGI job for the ADMIN HTTP server. Each CGI job is associated with a single user profile and only handles CGI requests for that user profile. By checking the user profile associated with a CGI job, you can determine which users IBM Web Administration for i log-on session its associated with. For example if the current user profile associated with a CGI job is a profile called JOEUSER, then that particular job is responsible for processing CGI requests for JOEUSERs IBM Web Administration for i log-on session. This concludes our discussion of the different types of IBM HTTP server jobs associated with the frontend Web server for IBM Web Administration for i. Now lets turn our attention to the IBM integrated Web application server jobs associated with IBM Web Administration for i.
how the IBM integrated Web application server gets associated with the ADMIN HTTP Server. Note this association between an HTTP server and an integrated Web application server may vary based on the IBM i release or the currently used version of the integrated Web application server. For our example, lets assume we are talking about an IBM i 7.1 system and a V8.1 integrated Web application server. The following include directive can be found in the ADMIN HTTP server configuration file (/QIBM/ProdData/HTTPA /admin/conf/admin-ibm.conf): include /QIBM/ProdData/OS/OSGi/LWISysInst/conf/admin-lwi.conf File admin-lwi.conf defines the association information between the ADMIN HTTP server and the ADMIN integrated Web application server. Here are the pertinent directives listed in file admin-lwi.conf responsible for allowing these servers to seamlessly work together: #--------------------------------------# LWI Admin1 Instance directives #--------------------------------------LoadModule mod_ibm_lwi /QSYS.LIB/QHTTPSVR.LIB/QLWIIHSMOD.SRVPGM LwiPluginConfig /QIBM/UserData/HTTPA/admin/conf/lwi-plugin-cfg.xml <LwiProfile Admin1> LwiAutostartOption StartEnd LwiStartJobQueue QHTTPSVR/QZHBHTTP HTTPWWW LwiAssignUserID QLWISVR </LwiProfile> #--------------------------------------# LWI Admin2 Instance directives #--------------------------------------<LwiProfile Admin2> LwiAutostartOption StartEnd LwiStartJobQueue QHTTPSVR/QZHBHTTP HTTPWWW LwiAssignUserID QLWISVR </LwiProfile> #--------------------------------------# LWI Admin3 Instance directives #--------------------------------------<LwiProfile Admin3>
LwiAutostartOption StartEnd LwiStartJobQueue QHTTPSVR/QZHBHTTP HTTPWWW LwiAssignUserID QLWISVR </LwiProfile> #--------------------------------------# LWI Admin4 Instance directives #--------------------------------------<LwiProfile Admin4> LwiAutostartOption StartEnd LwiStartJobQueue QHTTPSVR/QZHBHTTP HTTPWWW LwiAssignUserID QWEBADMIN </LwiProfile> The LoadModule directive activates module mod_ibm_lwi within the HTTP server to enable the application server specific directives of LwiPluginConfig, LwiProfile, LwiAutostartOption and LwiAssignUserID. Directive LwiPluginConfig defines the IBM integrated Web application server plug-in file used to route HTTP requests to the appropriate integrated Web application server instance based on the submitted request's Unified Resource Identifier (URI). Container directive LwiProfile defines the integrated Web application server instance name. In file admin-lwi.conf the following four integrated Web application server instances are specified: Admin1, Admin2, Admin3 and Admin4. Each of these instances will correlate to a job running in subsystem QHTTPSVR with the same name. The directive LwiAutostartOption specifies that the application server will be automatically started or stopped when the HTTP server starts or stops. Directive LwiStartJobQueue specifies the job queue that the application server job will be sent to prior to becoming active. The directive LwiAssignUserID specifies the user profile under which the application server jobs are running. This directive is deprecated and no longer used on IBM i 6.1 and later. The following CL command will show you the integrated Web application server instance jobs running in subsystem QHTTPSVR: WRKSBSJOB SBS(QHTTPSVR) Job User Type -----Status----ADMIN1 QLWISVR ADMIN2 QLWISVR ADMIN3 QLWISVR BATCHI ACTIVE BATCHI ACTIVE BATCHI ACTIVE
JVM-com.ibm.lw
Each job handles one integrated Web application server instance. These four instances are considered system-level jobs for hosting different Web applications. For example, the ADMIN2 job runs under the QLWISVR user profile and is responsible for running IBM Systems Director Navigator. The ADMIN4 job runs under the QWEBADMIN user profile and is responsible for running the IBM Web Administration for i GUI interface. This concludes our discussion of the IBM integrated Web application server jobs associated with IBM Web Administration for i. Now lets briefly discuss some log files an IBM i system administrator can review if there are any problems associated with IBM Web Administration for i.
A Clear Picture
After reading this article, you should have a clear picture of basic IBM i work management concepts related to starting and ending jobs and have a better understanding of what each ADMIN HTTP server jobs does. We also explained how the ADMIN HTTP server is able to be configured to communicate with the ADMIN integrated Web application server instance jobs to successfully run the IBM Web Administration for i application. If you should happen to have issues with any of the Web-based
interfaces, you now have the tools to review the error and logs files to help determine what might be causing the issues.