# [SAP] Import Queue ( Import Queue 정리 )

0. 이해를 위한 사전 지식

• CTS 란 ? 2023.08.23 - [SAP/BC] - # [SAP] CTS ( Change and Transport System )

# [SAP] CTS ( Change and Transport System )

• STMS 란 ? 2024.08.05 - [SAP/BC] - # [SAP] Transport Request - STMS

# [SAP] Transport Request - STMS

1. Import Queue

• Import Queue 란 SAP System 내에 이관된 CTS Request 내역 ( 흔히, 반영 내역 ) 을 보여주는 큐이다.
• CTS가 릴리즈 되면 Cofile과 Data 파일이 /usr/sap/trans 아래의 각 경로에 생성되며, TMS에 정의된 전송 경로에 따라 각 Import Queue에 들어가게 된다.
  Import Queue는 시스템 로컬 상 파일로 저장되며, 경로는 /usr/sap/trans/buffer/<SID> 이다.

sidap01:/usr/sap/trans/buffer > ll | grep SID
-rw-rw-r0-- 1 sidadm sapsys 3479 Dec 4 2023 SID

• SAP에서 Import Queue를 확인 하기 위해서는 아래 순서를 따르면 된다.
• T-code : STMS > Import Overview ( F5 ) >조회를 원하는 Queue 선택 

2. Import Queue Column ( Field )

• 아래 표는 일반적으로 Queue에서 확인 가능한 칼럼 별 내용이다.

Column	Description	Use
Number	Order in which the requests are imported	임포트된 Request의 순서로 시스템에 의해 채번된 번호
Request	Name of the Change request	<SID>K<Number> 형식의 request name으로 고유한 값을 가지기 때문에 필터를 이용하여 특정 Request를 찾기 위해 주로 사용
RC	Return Code	RC 값을 이용하여 Request 반영시 정상, 경고, 에러 등의 상태를 확인 할 수있다.
Owner	Change request owner	Request를 생성한 소유자
Project	Project name	-
Short Text	Change request short text	Request 생성 시 작성한 설명
St	Import Status of request	Request의 반영 상태를 나타낸다. RC가 결과에 대한 값을 Code로 보여준다면, St는 import 가 대기 중, 진행 혹은 Component Version이 일치하지 않는지와 같은 동적인 상태를 보여준다.

• 또한, 추가적인 다른 칼럼들을 확인하기 위해서는 상단의 Edit > Display More 기능을 이용하여 확인 할 수 있다,

 

3. Import Queue 정리

• 시스템을 사용하다 보면 Request가 지속적으로 생성되며, Import Queue에 쌓이게 된다. 이로인해 Import Queue Refresh ( 새로고침 ) 수행 시 점점 더 시간이 오래 걸리게 된다.
• 이를 해결하기 위해 주기적으로 Import Queue를 정리하는 작업을 진행해야 하는데, 아래와 같이 세가지 방법으로 수행이 가능하다.
  • OS 상에서 tp cleanbuffer 명령어 사용하는 방법
  • "/usr/sap/trans/buffer/<SID>" 파일을 직접 수정하는 방법
  • SAP GUI를 이용하여 정리하는 방법
• 위 세 방법의 수행 방식은 다르지만, 기본적인 틀은 /usr/sap/trans/buffer/SID 파일을 조작 ( 수정, 삭제 ) 하는 것이다.
• 따라서, 위 방법들을 수행하기 전 원복을 위해서는 아래와 같이 SID 파일을 백업해 두는 것을 권장한다.

# 백업 방법
SID:/usr/sap/trans/buffer > cp -rp <SID> <SID>.bak

# 원복 방법
SID:/usr/sap/trans/buffer > mv <SID>.bak <SID>

    1) tp cleanbuffer 명령어 사용 방법

• 수행 방법

# Import Queue를 정리하고자 하는 서버 접속 후, sidadm으로 계정 전환
hostname:~ > su - sidadm

# tp cleanbuffer <SID> pf=<DIR_TRANS>\bin\<TP PROFILE> 명령어 수행
hostname@sidadm > tp cleanbuffer SID pf=/usr/sap/trans/bin/TP_DOMAIN_SID.PFL

• 장점
  • 자동화 : 불필요한 항목을 자동으로 식별하고 제거
  • 안정성 : SAP 표준 도구를 사용하여 시스템의 일관성을 유지
  • 효율성 : 대규모 시스템에서 여러 항목을 한 번에 정리 가능
• 단점
  • 제어 부족 : 특정 Request를 선택적으로 삭제하는데는 적합하지 않음
  • 부하 발생 : 명령어 실행 시, 시스템 리소스를 사용하며, 대규모 시스템에서는 시간이 걸리 수 있음

    2) "/usr/sap/trans/buffer/SID" 파일을 직접 수정하는 방법

• 수행 방법

hostname:~ > su - sidadm
hostname@sidadm > vi /usr/sap/trans/buffer/<SID>

기존 형식 : /0/<Request>
변경 형식 : #0/<Request>

• 장점
  • 세밀한 제어 : 특정 항목을 선택적으로 삭제 가능
  • 즉각적인 변경 : 파일을 직접 수정하여 즉각적인 변경이 가능
• 단점
  • 위험성 : 수동 작업으로 인한 실수의 가능성이 있음
  • 비표준 절차 : SAP 표준 절차를 따르지 않기 때문에 예상치 못한 문제가 발생할 수 있음

    3) SAP GUI를 이용하여 정리하는 방법

• 수행방법
  • T-code : STMS > Import Overview ( F5 ) > 삭제 대상 Queue 선택 > 삭제 대상 Request 선택 ( F9 ) > 상단 메뉴바 Request 선택 > Delete 수행
  • 대량의 Request가 필요한 경우 Filter를 이용하여 Request 조회 > 시작 Request 선택 ( F6 ) > 끝 Request 선택 ( F6 ) > 상단 메뉴바 Request 선택 > Delete 수행

• 장점
  • 사용자 친화적 : GUI를 통해 쉽게 접근하고 사용 가능
  • 안정성 : SAP 표준 절차를 따르므로 시스템의 일관성 유지 가능
  • 로그 기록 : 삭제 작업이 로그에 기록되어 추적 가능 ( "/usr/sap/trans/log" 경로의 "SLOG" 혹은 "ALOG"를 통한 확인 혹은 SM37에서 백그라운드로 수행된 Import Queue 정리 작업 로그 확인 )
• 단점
  • 수동 작업 : 여러 Request를 삭제할 때는 반복적인 수동 작업이 필요하다.

    4) Shell Script를 이용하여 정리하는 방법

• 2024.09.22 - [SAP/BC] - # [SAP] Import Queue Clear Script ( 임포트 큐 정리 스크립트 )

# [SAP] Import Queue Clear Script ( 임포트 큐 정리 스크립트 )

 

 

🙋‍♂️ 궁금한 점이나 잘못된 내용을 댓글로 적어주시면 감사하겠습니다 !!

 

Ref.

• https://help.sap.com/doc/saphelp_nw75/7.5.5/en-US/c0/ec284b06b04724bd1d81b24e35a38b/content.htm?no_cache=true
• https://help.sap.com/doc/saphelp_nw73ehp1/7.31.19/en-US/44/b4a3777acc11d1899e0000e829fbbd/content.htm?no_cache=true
• https://me.sap.com/notes/1924741
• https://buddysap.com/meaning-of-the-return-codes-in-stms/#google_vignette
• https://velog.io/@yhjseed/SAP-%EC%9E%84%ED%8F%AC%ED%8A%B8-%ED%81%90-%EC%A0%95%EB%A6%AC-%EB%B0%A9%EB%B2%95How-to-clean-up-the-SAP-Import-Queue