JCL 프로시저를 사용하여 z/OS에서 IBM HTTP Server 시작

MVS™ 시스템 콘솔에서 IBM® HTTP Server를 시작 및 중지하는 JCL 프로시저를 준비할 수 있습니다.

apachectl 시작 및 중지 명령을 실행하는 JCL 카탈로그 프로시저를 사용하여 MVS 시스템 콘솔에서 IBM HTTP Server 인스턴스를 시작하고 중지할 수 있습니다. 같은 프로시저를 사용하여 MVS 시스템 콘솔에서 다른 apachectl 명령을 실행할 수도 있습니다.

SHAPJCL(HAPAPROC)에서 다음 샘플 JCL 프로시저를 시스템 프로시저 라이브러리에 복사하십시오.

//*---------------------------------------------------------
//IHSAPACH PROC ACTION='start',
//          DIR='/path/to/IHS/runtime/directory',
//          CONF='conf/httpd.conf'
//*---------------------------------------------------------
//IHS      EXEC PGM=BPXBATCH,
// PARM='SH &DIR/bin/apachectl -k &ACTION -f &CONF -DNO_DETACH',
// MEMLIMIT=512M
//STDOUT   DD		PATH='&DIR/logs/proc.output',
//				PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//				PATHMODE=(SIRUSR,SIWUSR,SIRGRP,SIWGRP)
//STDERR   DD		PATH='&DIR/logs/proc.errors',
//				PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//				PATHMODE=(SIRUSR,SIWUSR,SIRGRP,SIWGRP)
//         PEND
경고: PARM 값은 100자로 제한되어 있습니다. PARM 값은 설치 디렉토리(&DIR)를 포함하므로 디렉토리 경로가 너무 긴 경우에는 총 길이가 100자를 초과할 수 있습니다. 설치 디렉토리를 선택할 때는 경로 이름 길이를 고려해야 합니다. 설치 디렉토리 경로 이름이 너무 긴 경우에는 원래 설치 디렉토리 경로 이름에 기호로 링크된 JCL에 있는 더 짧게 이름 지정된 경로를 사용할 수 있습니다.
100자보다 긴 PARM 값이 필요한 경우에는 아래 예제에 표시되어 있는 바와 같이 /PARMIN DD *,SYMBOLS=JCLONLY JCL 카드를 사용할 수 있습니다.
/*------------------------------------------------------
//WEBFTNEI JOB (KOMA-Y98),'Apache NZX2      ',MSGCLASS=T,
//  TIME=NOLIMIT                                        
//         EXPORT SYMLIST=*                             
//*-------------------------------------                
//  SET  ACTION='start'                                 
//  SET  DIR='/home/ihsa/install/webft'                 
//  SET  CONF='../../httpd/webftnei.conf'               
//*-----------------------------------------------------
//IHS EXEC PGM=BPXBATCH,PARMDD=PARMIN,                  
// MEMLIMIT=512M
//PARMIN   DD *,SYMBOLS=JCLONLY                         
PGM &DIR/bin/apachectl                                  
   -k &ACTION
   -f &CONF
   -DNO_DETACH
//*-------------------------------------------------------
//STDOUT   DD SYSOUT=T                                    
//*                                                        
//STDERR   DD SYSOUT=T                                     
//*                                                       
//                                                        
//STDOUT   DD		PATH='&DIR/logs/proc.output',
//				PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//				PATHMODE=(SIRUSR,SIWUSR,SIRGRP,SIWGRP)
//*                                                      
//STDERR   DD		PATH='&DIR/logs/proc.errors',
//				PATHOPTS=(OWRONLY,OCREAT,OTRUNC),
//				PATHMODE=(SIRUSR,SIWUSR,SIRGRP,SIWGRP)
//                                                        
/*---------------------------------------------------------- 

샘플 JCL에 사용된 apachectl 명령에 대한 설명은 Apache HTTP Server 제어 인터페이스 웹 사이트에 있습니다.

IBM HTTP Server 인스턴스의 기본 작업 이름은 카탈로그 프로시저의 구성원 이름과 동일합니다. 웹 서버는 다중 프로세스 서버이며 작성되는 각 추가 프로세스에는 원본 작업 이름을 기반으로 하여 생성된 작업 이름이 부여됩니다. 원본 작업 이름의 길이가 8자인 경우에는 모든 추가 프로세스가 같은 작업 이름을 갖습니다. 원본 작업 이름의 길이가 8자 미만인 경우 추가 프로세스는 원본 작업 이름과 추가 숫자 접미부로 구성된 작업 이름을 갖습니다. 웹 서버가 bin/apachectl 명령을 사용하여 UNIX 환경에서 시작된 경우 기본 작업 이름은 이 명령을 실행한 사용자 ID입니다. 작업 이름의 경우 사용자 ID의 길이가 8자면 모든 추가 프로세스가 같은 작업 이름을 갖습니다. 사용자 ID의 길이가 8자 미만인 경우 프로세스는 사용자 ID와 추가 숫자 접미부로 구성된 작업 이름을 갖습니다.

다음 예제에서는 프로시저 이름 WEBSRV1을 사용합니다. /path/to/IHS/runtime/directory를 이 IBM HTTP Server 인스턴스의 실제 설치 디렉토리로 바꿔 새 카탈로그 프로시저를 편집하십시오. 서버 사용자 ID와 그룹이 웹 서버 시작 태스크와 연관되도록 SAF STARTED 프로파일을 작성하십시오.
RDEFINE STARTED WEBSRV1.* STDATA(USER(WWWSERV) GROUP(WWWGROUP) TRACE(YES))
SETROPTS RACLIST(STARTED) GENERIC(STARTED) REFRESH
  • MVS 시스템 콘솔에서 서버를 시작하려면 다음을 입력하십시오.
    S WEBSRV1
    참고: 웹 서버 이름은 jobname을 시작 명령에 추가하여 변경할 수 있습니다. 예를 들면, 다음과 같습니다.
    S WEBSRV1,JOBNAME=HTTPDWS1
    우수 사례 1: 8자 작업 이름을 사용하십시오. 8자 작업 이름을 사용하면 웹 서버의 이 인스턴스에 대해 작성되는 모든 프로세스가 같은 작업 이름을 갖습니다.
    서버를 중지하려면 다음을 입력하십시오.
    P WEBSRV1
    참고: SDSF를 사용하는 경우 시스템 명령 확장(명령 입력) 화면을 사용하여 서버 중지 명령을 입력해야 합니다.
    • 명령 프롬프트에서 슬래시(/)를 입력한 후 Enter를 눌러 시스템 명령 확장 창에 액세스하십시오.
    • 시스템 명령 확장 창에서 S WEBSRV1,ACTION='stop' 명령을 입력하십시오. stop이 소문자인지 확인하십시오.
  • 기타 apachectl 명령을 발행하려면 다음을 입력하십시오.
    S WEBSRV1,ACTION='<command>'
  • 서버를 다시 시작하려면 다음을 입력하십시오.
    S WEBSRV1,ACTION=restart
    z/OS 콘솔에서 서버를 다시 시작할 수 있습니다.
  • 서버를 빠르게 다시 시작하려면 다음을 입력하십시오.
    S WEBSRV1,ACTION=graceful
    z/OS 콘솔에서 서버를 빠르게 다시 시작할 수 있습니다.

시작 및 중지 명령의 출력 파일은 이 프로시저의 STDOUT 및 STDERR DD JCL문에 지정된 파일에 있습니다.

zos_cmds 모듈 사용: zos_cmds 모듈이 활성 상태인 경우에는 z/OS STOPMODIFY 콘솔 명령을 사용할 수 있습니다.
중요사항: zos_cmds 모듈을 활성화하려면 httpd.conf 파일에 다음 행을 추가해야 합니다.
LoadModule zos_cmds_module modules/mod_zos_cmds.so 
참고: 모든 프로세스에서 동일한 8자 작업 이름을 사용하고 있지 않은 경우에는 z/OS 운영자 명령을 처리하고 있는 프로세스의 작업 이름이 웹 서버의 인스턴스인지 판별해야 합니다. 웹 서버는 시작되면서 운영자 명령을 처리하고 있는 작업을 식별하는 메시지를 운영자 콘솔에 발행합니다.
BPXM023I (WASTST1) IHS is active. Use jobname HTTPDWS1 for MVS commands.
여기서 WASTST1은 웹 서버를 실행 중인 사용자 ID입니다. 오류 로그에도 작업 이름을 식별하는 항목이 기록됩니다. mod_zos_cmds 디먼 작업 이름은 HTTPDWS1이라는 점을 참고하십시오. MODIFY 명령이 입력될 때 이 명령은 지정된 작업 이름을 가진 모든 작업을 대상으로 합니다. 오직 하나의 웹 서버 프로세스만 이 명령을 수락합니다. 시스템은 같은 이름을 가진 각 다른 작업에 대해 다음 메시지를 발행합니다.
IEE342I MODIFY   REJECTED-TASK BUSY
  • 중지 명령을 사용하여 서버를 중지하려면 다음 내용을 입력하십시오.
    P HTTPDWS1
  • 수정 명령을 사용하여 서버를 다시 시작하려면 다음 내용을 입력하십시오.
    F HTTPDWS1,appl='restart'
  • 수정 명령을 사용하여 서버를 단계적으로 다시 시작하려면 다음 내용을 입력하십시오.
    F HTTPDWS1,appl='graceful'
zos cmds 모듈이 활성화된 상태에서 웹 서버가 중지되면 웹 서버는 운영자 콘솔에 다음 메시지를 발행합니다.
BPXM023I (WASTST1) IHS is stopping
여기서 WASTST1은 웹 서버를 실행 중인 사용자 ID입니다.
우수 사례 2: 출력 파일은 프로시저를 사용할 때마다 겹쳐씁니다. 이 파일에는 구성에 대한 경고 메시지나 시작 실패에 대한 오류 메시지가 포함될 수 있습니다. 프로시저를 여러 번 사용하는 동안 이러한 메시지의 로그를 보유하려면 샘플 프로시저에서 두 번 발생하는 PATHOPTS 옵션을 PATHOPTS=(OCREAT,OAPPEND,OWRONLY)로 수정하십시오. PATHOPTS 옵션에 대한 자세한 정보는 z/OS® MVS JCL Reference(SA22-7597)를 참조하십시오. z/OS 인터넷 라이브러리에서 이 문서에 링크하십시오.
우수 사례 3: STDENV DD 문은 권장되지 않습니다. 런타임 디렉토리 내 bin/envvars 파일에 환경 변수 설정을 추가하면 IBM HTTP Server가 JCL 또는 UNIX 환경에서 시작되었는지 여부에 관계 없이 변수가 활성화됩니다.
우수 사례 4: PGM 매개변수 대신 BPXBATCH의 SH 매개변수가 권장됩니다. PGM 매개변수에 대한 처리는 umask 설정을 포함한 /etc/profile 파일의 시스템 기본 설정을 무시하며 IBM HTTP Server가 작성한 파일에는 올바른 권한이 없습니다.

주제 유형을 표시하는 아이콘 개념 주제



시간소인 아이콘 마지막 업데이트 날짜: last_date
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=ihs-dist&topic=cihs_startsysconz
파일 이름:cihs_startsysconz.html