CHECKOUT LIBVOLUME(라이브러리의 스토리지 볼륨 체크아웃)

이 명령은 자동화 라이브러리의 서버 자원 명세에서 순차 액세스 스토리지 볼륨을 제거하는 데 사용합니다. 이 명령은 CANCEL PROCESS 명령으로 취소할 수 있는 백그라운드 프로세스를 작성합니다. 백그라운드 프로세스에 대한 정보를 표시하려면 QUERY PROCESS 명령을 사용하십시오.

권한 클래스

이 명령을 실행하려면 시스템 권한이나 제한되지 않은 스토리지 권한이 있어야 합니다.

제한사항:
  1. 체크아웃 처리는 드라이브가 IDLE 상태인 경우에도 드라이브가 사용 가능하게 되기를 기다리지 않습니다. 필요한 경우, DISMOUNT VOLUME 명령으로 볼륨을 마운트 해제하여 라이브러리 드라이브를 사용 가능하게 할 수 있습니다. 드라이브가 사용 가능하게 되면 CHECKOUT LIBVOLUME 명령을 다시 실행할 수 있습니다.
  2. 349X 라이브러리에서 볼륨을 체크아웃하기 전에, 349x 카트리지 입력 및 출력 장치에 볼륨을 체크아웃하기에 충분한 빈 슬롯이 있는지 확인하십시오. 3494 라이브러리 관리자는 애플리케이션에 카트리지 입력 및 출력 장치가 가득찼음을 알리지 않습니다. 카트리지 방출 요청을 받아들이고 서버로 리턴하기 전에 카트리지 입력 및 출력 장치가 비우게 될 때까지 기다립니다. IBM Storage Protect 는 정지되지 않은 경우 정지된 것으로 표시될 수 있습니다. 라이브러리를 검사하여 모든 개입 요청을 지우십시오.
  3. ACSLS 라이브러리에서 볼륨을 체크아웃하기 전에, ACSLS의 CAP 우선순위가 0보다 큰지 확인하십시오. CAP 우선순위가 0이면 CHECKOUT LIBVOLUME 명령에 CAP 매개변수의 값을 지정해야 합니다.
상세한 최신 드라이브 및 라이브러리 지원 정보는 운영 체제에 맞는 지원되는 디바이스 웹 사이트를 참조하십시오.

SCSI 라이브러리 구문

구문 다이어그램 읽기비주얼 구문 다이어그램 건너뛰기 CHECKOut LIBVolume라이브러리 이름volume_nameAREMove=BulkREMove=YesNoBulkCHECKLabel=YesCHECKLabel=YesNoFORCE=NoFORCE=NoYes
A
구문 다이어그램 읽기비주얼 구문 다이어그램 건너뛰기VOLRange=volume_name1,volume_name2VOLList=,volume_nameFILE:file_name

349X 라이브러리 구문

구문 다이어그램 읽기비주얼 구문 다이어그램 건너뛰기CHECKOut LIBVolume 라이브러리 이름volume_nameAREMove=BulkREMove=YesNoBulk
A
구문 다이어그램 읽기비주얼 구문 다이어그램 건너뛰기VOLRange=volume_name1,volume_name2VOLList=,volume_nameFILE:file_name

ACSLS 라이브러리 구문

구문 다이어그램 읽기비주얼 구문 다이어그램 건너뛰기CHECKOut LIBVolume라이브러리 이름 volume_nameAREMove=YesREMove=YesNoBulkCAP=x, y, z
A
구문 다이어그램 읽기비주얼 구문 다이어그램 건너뛰기VOLRange=volume_name1,volume_name2VOLList=,volume_nameFILE:file_name

매개변수

library_name (필수)
라이브러리 이름을 지정합니다.
볼륨_이름
볼륨 이름을 지정합니다.
VOLRange
두 개의 볼륨 이름을 쉼표로 구분하여 지정합니다. 이 매개변수는 체크아웃할 볼륨의 범위입니다. 지정된 범위 내에 있는 라이브러리에 볼륨이 없으면, 명령은 오류없이 완료됩니다.

수적으로 증가시킬 수 있는 볼륨 이름만 지정하십시오. 증가분 영역과 볼륨 이름에 영숫자 접두어와 영숫자 접미어를 포함할 수 있습니다. 예를 들면, 다음과 같습니다.

매개변수 설명
volrange=bar110,bar130 bar110, bar111, bar112,...bar129, bar130의 21개 볼륨이 체크아웃됩니다.
volrange=bar11a,bar13a bar11a, bar12a, bar13a의 세 개의 볼륨이 체크아웃됩니다.
volrange=123400,123410 123400, 123401, ...123409, 123410의 11개 볼륨이 체크아웃됩니다.
VOLList
체크아웃할 볼륨 목록을 지정합니다. 목록에 있는 라이브러리에 볼륨이 없으면, 명령이 오류 없이 완료됩니다.

사용 가능한 값은 다음과 같습니다.

볼륨_이름
명령에 사용될 하나 이상의 값의 이름을 지정합니다. 예, VOLLIST=TAPE01,TAPE02.
파일:file_name
명령에 대한 볼륨 목록이 들어 있는 파일 이름을 지정합니다. 파일의 각 볼륨 이름은 분리된 행에 있어야 합니다. 별표로 시작되는 공백 행 및 주석 행은 무시됩니다. 예를 들어, TAPE01, TAPE02 및 TAPE03 볼륨을 사용하려면, 다음 행을 포함하는 TAPEVOL 파일을 작성하십시오.
TAPE01
TAPE02
TAPE03

VOLLIST=FILE:TAPEVOL과 같이 명령에 대한 볼륨을 지정할 수 있습니다.

주의: 파일 이름은 대소문자를 구분합니다.
REMove
서버가 라이브러리 외부와 편리 입/출력 스테이션 또는 입/출력 포트로 볼륨 이동을 시도하도록 지정합니다. 이 매개변수는 선택사항입니다. 라이브러리 유형에 따라 가능한 값은 YES, BULK 및 NO입니다. 각 옵션에 대한 서버의 응답 및 기본값은 다음 절에 설명되어 있습니다.
349X 라이브러리: 기본값은 BULK입니다. 다음 표는 349X 라이브러리에 대해 서버가 응답하는 방법을 보여줍니다.
표 1. 서버가 349X 라이브러리에 응답하는 방법
REMOVE=YES REMOVE=BULK REMOVE=NO
3494 라이브러리 관리자는 카트리지를 편리 입/출력 스테이션으로 방출합니다. 3494 라이브러리 관리자는 카트리지를 고용량 출력 장치로 방출합니다. 3494 라이브러리 관리자는 볼륨을 방출하지 않습니다.

서버는 다른 애플리케이션이 사용할 수 있도록 INSERT 카트리지의 라이브러리에 카트리지를 그대로 둡니다.

SCSI 라이브러리: 기본값은 BULK입니다. 다음 표는 SCSI 라이브러리에 대해 서버가 응답하는 방법을 보여줍니다.
표 2. 서버가 SCSI 라이브러리에 응답하는 방법
라이브러리 유형
And REMOVE=YES,
응답
And REMOVE=BULK,
응답
And REMOVE=NO,
응답
입/출력 포트를 갖지 않습니다. 서버는 카트리지를 라이브러리 내의 현재 슬롯에 두고 메시지에 슬롯 주소를 지정합니다.

그런 다음 서버는 슬롯에서 카트리지를 제거하고 REPLY 명령을 실행하라는 프롬프트를 표시합니다.

서버는 카트리지를 라이브러리 내의 현재 슬롯에 두고 메시지에 슬롯 주소를 지정합니다.

서버는 카트리지를 제거하라는 프롬프트를 표시하지 않으므로 REPLY 명령이 필요하지 않습니다.

서버는 카트리지를 라이브러리 내의 현재 슬롯에 두고 메시지에 슬롯 주소를 지정합니다.

서버는 카트리지를 제거하라는 프롬프트를 표시하지 않으므로 REPLY 명령이 필요하지 않습니다.

입/출력 포트를 갖고 입/출력 포트가 사용 가능합니다. 서버는 카트리지를 사용 가능한 입/출력 포트로 이동한 후 메시지에 포트 주소를 지정합니다.

그런 다음 서버는 슬롯에서 카트리지를 제거하고 REPLY 명령을 실행하라는 프롬프트를 표시합니다.

서버는 카트리지를 사용 가능한 입/출력 포트로 이동한 후 메시지에 포트 주소를 지정합니다.

서버는 카트리지를 제거하라는 프롬프트를 표시하지 않으므로 REPLY 명령이 필요하지 않습니다.

서버는 카트리지를 라이브러리 내의 현재 슬롯에 두고 메시지에 슬롯 주소를 지정합니다.

서버는 카트리지를 제거하라는 프롬프트를 표시하지 않으므로 REPLY 명령이 필요하지 않습니다.

입/출력 포트를 갖지만 사용 가능한 포트가 없습니다 서버는 카트리지를 라이브러리 내의 현재 슬롯에 두고 메시지에 슬롯 주소를 지정합니다.

그런 다음 서버는 슬롯에서 카트리지를 제거하고 REPLY 명령을 실행하라는 프롬프트를 표시합니다.

서버는 입/출력 포트가 사용 가능해지기를 기다립니다. 서버는 카트리지를 라이브러리 내의 현재 슬롯에 두고 메시지에 슬롯 주소를 지정합니다.

서버는 카트리지를 제거하라는 프롬프트를 표시하지 않으므로 REPLY 명령이 필요하지 않습니다.

ACSLS 라이브러리: 기본값은 YES입니다. 매개변수가 YES로 설정되고 카트리지 액세스 포트(CAP)에서 자동 선택 우선순위 값이 0인 경우 CAP ID를 지정해야 합니다. 다음 표는 서버가 ACSLS 라이브러리에 응답하는 방법을 보여줍니다.
표 3. 서버가 ACSLS 라이브러리에 응답하는 방법
REMOVE=YES 또는 REMOVE=BULK REMOVE=NO
서버는 카트리지를 편리 I/O 스테이션으로 방출하며 서버 라이브러리 자원 명세에서 볼륨 항목을 삭제합니다. 서버는 카트리지를 방출하지 않습니다. 서버는 서버 라이브러리 자원 명세에서 볼륨 항목을 삭제한 후 라이브러리에 볼륨을 그대로 둡니다.
CHECKLabel
서버가 볼륨의 순차 매체 레이블을 읽는 방법이나 읽기 여부를 지정합니다.
주의: 이 매개 변수는 IBM® 349X 또는 ACSLS 라이브러리에는 적용되지 않습니다.
이 매개변수는 선택사항입니다. 기본값은 YES입니다. 사용 가능한 값은 다음과 같습니다.
Yes
올바른 볼륨이 체크아웃되고 있는지 확인하기 위해 서버가 매체 레이블 읽기를 시도하도록 지정합니다.
No
체크아웃 중에 매체 레이블을 읽지 않도록 지정합니다. 이는 읽기 프로세스가 발생하지 않기 때문에 성능을 개선합니다.
FORCE
레이블을 읽을 때 입/출력 오류가 발생하면, 서버가 볼륨을 체크아웃할 것인지 여부를 지정합니다.
주의: 이 매개변수는 IBM 349X 또는 ACSLS 라이브러리에 적용되지 않습니다.
이 매개변수는 선택사항입니다. 기본값은 NO입니다. 사용 가능한 값은 다음과 같습니다.
No
레이블을 읽을 때 입/출력 오류가 발생하면, 서버는 스토리지 볼륨을 체크아웃하지 않습니다.
Yes
입/출력 오류가 발생한 경우에도 서버는 스토리지 볼륨을 체크아웃합니다.
CAP
REMOVE=YES를 지정하는 경우, 볼륨을 방출하는 데 사용할 CAP(Cartridge Access Port)를 지정합니다. 이 매개변수는 ACSLS 라이브러리의 볼륨에만 적용됩니다. CAP 우선순위 값이 라이브러리에서 0으로 설정된 경우 이 매개변수가 필요합니다. 라이브러리에서 0보다 큰 CAP 우선순위 값이 설정된 경우 이 매개변수는 선택사항입니다. 기본적으로 모든 CAP의 처음 우선순위 값은 0으로, ACSLS가 자동으로 CAP을 선택하지 않음을 의미합니다.
올바른 CAP ID (x, y, z) 를 표시하려면 ACSLS 서버 호스트의 ACSSA (Automated Cartridge System System Administrator) 콘솔에서 지정된 ALL 와 함께 QUERY CAP 명령을 실행하십시오. ID는 다음과 같습니다.
x
ACS(Automated Cartridge System) ID. 이 ID는 0에서 126 사이 범위의 숫자일 수 있습니다.
y
LSM(Library Storage Module) ID. 이 ID는 0에서 23 사이 범위의 숫자일 수 있습니다.
z
CAP ID입니다. 이 ID는 0에서 11 사이 범위의 숫자일 수 있습니다.
자세한 정보는 StorageTek 문서를 참조하십시오.

예제: 볼륨 체크아웃 및 레이블 확인

FOREST라는 라이브러리에서 EX0004라는 볼륨을 체크아웃합니다. 레이블을 읽어 볼륨 이름을 확인하고 라이브러리에서 다른 위치로 볼륨을 이동시키지는 않습니다.
checkout libvolume forest exb004 checklabel=yes remove=no

관련 명령

표 4. CHECKOUT LIBVOLUME 관련 명령
명령 설명
감사 라이브러리 자동화 라이브러리가 일관성 있는 상태에 있음을 보장합니다.
프로세스 취소 백그라운드 서버 프로세스를 취소합니다.
체크인 라이브러리 볼륨 자동화 라이브러리에 스토리지 볼륨을 체크인합니다.
라이브러리 정의 자동 또는 수동 라이브러리를 정의합니다.
볼륨 정의 지정된 스토리지 풀 내에 저장에 사용될 볼륨을 지정합니다.
레이블 LIBVOLUME 수동 또는 자동화 라이브러리의 볼륨을 레이블링합니다.
QUERY 라이브러리 하나 이상의 라이브러리에 대한 정보를 표시합니다.
라이브러리 볼륨 쿼리 라이브러리 볼륨에 대한 정보를 표시합니다.
QUERY 프로세스 백그라운드 프로세스에 대한 정보를 표시합니다.
응답 요청이 처리를 계속하도록 허용합니다.
LIBVOLUME 갱신 스토리지 볼륨의 상태를 변경합니다.