3 XCMD XAPI 구성 및 관리 명령

이 장에서는 XCMD에서 지원되는 XAPI 구성 및 관리 명령에 대해 설명합니다. 이러한 명령은 ACSLS 릴리스 8.4에서 ELS 호환 볼륨 풀 기능을 사용으로 설정합니다. 지원되는 명령은 다음과 같습니다.

XCMD 명령을 사용해서 ACSLS user_proc에서 이러한 명령을 실행합니다. 자세한 내용은 제 2 장 XCMD 명령 규약을 참조하십시오.

다음 명령 섹션에 포함된 구문 플로우 다이어그램에 사용되는 규약은 구문 표기법을 참조하십시오.

DEFINE POOL_Name

다음 절에서는 DEFINE POOL_Name 명령에 대해 설명합니다.

설명

DEFINE POOL_NAME 명령은 풀 유형 및 풀 이름을 ACSLS 풀 ID와 연결합니다.

구문

다음 그림은 DEFINE POOL_Name 명령의 구문을 보여줍니다.

그림 3-1 DEFINE POOL_Name 명령 구문

주변 텍스트에서 그림 3-1 에 관해 설명합니다.

매개변수

그림 3-1에 표시된 것처럼 DEFINE POOL_Name 명령에는 다음 매개변수가 포함됩니다.

pool_name

최대 13자의 풀 이름. 풀 이름은 퍼센트 기호("%"), 밑줄("_") 또는 별표("*")를 제외한 모든 문자를 포함할 수 있습니다.

POOLTYpe

Scratch(기본값) 또는 Mvc의 풀 유형.

POOLId(nnnnn)

선택적으로, 풀 ID(nnnnn)를 지정합니다.

  • 이 매개변수를 지정하도록 선택한 경우, 현재 존재하지 않는 풀 ID를 지정해야 합니다.

  • 이 매개변수를 지정하지 않으면 시스템이 10000부터 시작해서 사용되지 않은 첫번째 값으로 풀 ID를 자동으로 지정합니다.

다음 예에서 사용자는 DEFINE POOL_Name 명령을 실행해서 스크래치 풀 SCRPOOL1을 정의합니다.

XCMD DEFINE POOL_NAME SCRPOOL1 POOLTYPE SCRATCH

DEFINE POOL_Access

다음 절에서는 DEFINE POOL_Access 명령에 대해 설명합니다.

설명

DEFINE POOL_Access 명령은 지정된 호스트에서 pool_name에 대해 허용되는 액세스를 정의합니다. 특정 pool_name에 대해 풀 액세스가 정의되지 않은 경우 모든 액세스가 허용됩니다.

구문

다음 그림은 DEFINE POOL_Access 명령의 구문을 보여줍니다.

그림 3-2 DEFINE POOL_Access 명령 구문

주변 텍스트에서 그림 3-2 에 관해 설명합니다.

매개변수

그림 3-2에 표시된 것처럼 DEFINE POOL_Access 명령에는 다음 매개변수가 포함됩니다.

pool_name

최대 13자의 풀 이름. 풀 이름은 퍼센트 기호("%"), 밑줄("_") 또는 별표("*")를 제외한 모든 문자를 포함할 수 있습니다. 지정된 pool_nameSCRATCH 풀 유형과 함께 DEFINE POOL_Name 명령을 사용해서 이전에 정의되어 있어야 합니다(MVC 풀에 대해 액세스가 정의되지 않음). 자세한 내용은 DEFINE POOL_Name을 참조하십시오.

HOSTid host_name

최대 31자의 호스트 이름을 지정합니다. 이 매개변수는 필수입니다.

지정된 HOSTid는 인터넷 전체 도메인 이름 중에서 호스트 이름 부분입니다. 예를 들어, 전체 도메인 이름이 myhost.plus.domain.name인 경우, 지정된 HOSTidmyhost입니다.

ALLOWMount

선택적으로, 마운트 액세스를 지정합니다. True 또는 False를 지정할 수 있습니다. 이 매개변수는 POOLTYPE MVC로 정의된 풀에 대해서만 유효합니다.

ALLOWSELscratch

선택적으로, 스크래치 볼륨에 대해 XAPI 명령 query_scr_mnt_info, sel_scratchmount에 대한 액세스를 지정합니다. True 또는 False를 지정할 수 있습니다. 이 매개변수를 지정하지 않으면 기본적으로 True로 설정됩니다.

이 매개변수는 POOLTYPE SCRATCH로 정의된 풀에 대해서만 유효합니다. MVC로 정의된 풀에 대해 이 매개변수를 지정할 경우 매개변수가 자동으로 기본값 False로 설정됩니다.

ALLOWSCRatch

선택적으로, 스크래치 액세스를 지정합니다. True 또는 False를 지정할 수 있습니다. 이 매개변수를 지정하지 않으면 기본적으로 True로 설정됩니다.

이 매개변수는 POOLTYPE SCRATCH로 정의된 풀에 대해서만 유효합니다. MVC로 정의된 풀에 대해 이 매개변수를 지정할 경우 매개변수가 자동으로 기본값 False로 설정됩니다.

다음 예에서 사용자는 DEFINE POOL_Access 명령을 실행해서 스크래치 풀 이름 SCRPOOL1에 대해 set access를 정의합니다. 여기서 호스트는 PRODMVS이고 ALLOWMOUNTALLOWSCRATCHTrue입니다.

XCMD DEFINE POOL_ACCESS SCRPOOL1 HOSTID PRODMVS ALLOWMOUNT TRUE ALLOWSCRATCH TRUE

DELETE POOL_Name

다음 절에서는 DELETE POOL_Name 명령에 대해 설명합니다.

설명

DELETE POOL_Name 명령은 풀을 삭제합니다. 이 명령은 ACSLS delete pool 명령과 비슷하지만 다음과 같은 예외사항이 있습니다.

  • 입력은 pool ID 대신 pool name을 지정합니다.

  • 사용자는 풀에 지정된 볼륨을 풀 0에 다시 지정할 수 있습니다.

ACSLS delete pool 명령에 대한 자세한 내용은 StorageTek Automated Cartridge System Library Software (ACSLS) Administrator’s Guide를 참조하십시오.

구문

다음 그림은 DELETE POOL_Name 명령의 구문을 보여줍니다.

그림 3-3 DELETE POOL_Name 명령 구문

주변 텍스트에서 그림 3-3 에 관해 설명합니다.

매개변수

그림 3-3에 표시된 것처럼 DELETE POOL_Name 명령에는 다음 매개변수가 포함됩니다.

pool_name

최대 13자의 풀 이름. 풀 이름은 퍼센트 기호("%"), 밑줄("_") 또는 별표("*")를 제외한 모든 문자를 포함할 수 있습니다. 지정된 pool_nameDEFINE POOL_Name 명령을 사용해서 이전에 정의되어 있어야 합니다. 자세한 내용은 DEFINE POOL_Name을 참조하십시오.

RESETvols

삭제하려는 풀에 현재 지정된 볼륨을 풀 0에 다시 지정해야 함을 나타냅니다. 이 매개변수를 지정하지 않고, 볼륨이 현재 풀 내에 존재하면 delete pool-name 명령이 실패합니다.

다음 예에서 사용자는 DELETE POOL_Name 명령을 실행해서 SCRPOOL1 풀을 삭제하고 해당 볼륨을 풀 0(기본 풀)에 다시 지정합니다.

XCMD DELETE POOL_NAME SCRPOOL_TEST1 RESETVOLS

DELETE POOL_Access

다음 절에서는 DELETE POOL_Access 명령에 대해 설명합니다.

설명

DELETE POOL_Access 명령은 단일 호스트 이름(host_id)과 연관된 풀 액세스 규칙을 삭제하거나 모든 호스트에 대한 모든 풀 액세스 규칙을 삭제합니다.

  • 호스트 이름(host_id)이 지정된 경우 지정된 호스트에 대한 액세스 규칙만 지정된 풀에서 삭제됩니다.

  • ALLhost가 지정된 경우 해당 풀의 모든 풀 액세스 규칙이 삭제됩니다.

구문

다음 그림은 DELETE POOL_Access 명령의 구문을 보여줍니다.

그림 3-4 DELETE POOL_Access 명령 구문

주변 텍스트에서 그림 3-4 에 관해 설명합니다.

매개변수

DELETE POOL_Access 명령 구문에 표시된 것처럼 DELETE POOL_Access 명령에는 다음 매개변수가 포함됩니다.

pool_name

최대 13자의 풀 이름. 풀 이름은 퍼센트 기호("%"), 밑줄("_") 또는 별표("*")를 제외한 모든 문자를 포함할 수 있습니다. 지정된 pool_nameDEFINE POOL_Name 명령을 사용해서 이전에 정의되어 있어야 합니다. 자세한 내용은 DEFINE POOL_Name을 참조하십시오.

HOSTid host_name

선택적으로, 최대 31자의 호스트 이름을 지정하고 이 호스트 ID에 대한 액세스 제한을 제거해야 함을 나타냅니다(변경되지 않은 상태의 다른 호스트 ID 액세스 규칙 사용). 이 매개변수는 ALLhost와 상호 배타적입니다.

ALLhost

선택적으로, 모든 호스트 ID에 대한 특정 pool_name의 모든 액세스 제한이 제거되도록 지정합니다. 이 매개변수는 HOSTid와 상호 배타적입니다.

다음 예에서 사용자는 DELETE POOL_Access 명령을 실행해서 PRODMVS 호스트에서 SCRPOOL1로의 풀 액세스를 삭제합니다.

XCMD DELETE POOL_ACCESS SCRPOOL1 HOSTID PRODMVS

SET POOL_Name

다음 절에서는 SET POOL_Name 명령에 대해 설명합니다.

설명

SET POOL_Name 명령은 볼륨을 풀 이름에 지정하거나 풀 이름에 대해 하위 워터마크를 설정합니다.

주:

명령 구문이 유효한 경우, 범위 내 일부 볼륨을 풀에 추가할 수 없더라도 지정된 볼륨 범위가 데이터베이스에 추가됩니다. 다음 중 하나가 true인 경우 볼륨을 풀에 추가할 수 없습니다.
  • 볼륨이 LOCK되어 있습니다.

  • FORCE가 지정되지 않은 한 볼륨이 이미 다른 풀에 있습니다.

  • 볼륨이 논리적 라이브러리에 있습니다.

  • 볼륨에 ACSLS 소유자가 포함되며 액세스 제어가 사용됩니다.

구문

다음 그림은 SET POOL_Name 명령의 구문을 보여줍니다.

그림 3-5 SET POOL_Name 명령 구문

주변 텍스트에서 그림 3-5 에 관해 설명합니다.

매개변수

그림 3-5에 표시된 것처럼 SET POOL_Name 명령에는 다음 매개변수가 포함됩니다.

pool_name

최대 13자의 풀 이름. 풀 이름은 퍼센트 기호("%"), 밑줄("_") 또는 별표("*")를 제외한 모든 문자를 포함할 수 있습니다. 지정된 pool_nameDEFINE POOL_Name 명령을 사용해서 이전에 정의되어 있어야 합니다. 자세한 내용은 DELETE POOL_Name을 참조하십시오.

LOWwater nnnnnnn

선택적으로, 풀이 포함해야 하는 사용 가능한 볼륨의 최소 개수를 정의합니다. 사용 가능한 볼륨 수가 하위 워터마크 아래로 떨어지면 ACSLS 시스템이 경고 메시지를 생성합니다.

VOLumes 또는 VOLSer(volser-list, volser-range, range-list)

선택적으로, volser 목록, volser 범위 또는 volser 범위 목록을 지정합니다. 최대 16개의 단일 볼륨 또는 범위를 지정할 수 있습니다.

볼륨 범위는 ACSII 조합 시퀀스인 ACSLS 형식 volser 범위에 따라 평가되며, HSC 볼륨 패턴 범위를 따를 필요가 없습니다. 하지만 단일 범위의 볼륨 일련 번호는 동일한 문자 수를 포함해야 하며, 일치하는 문자 수의 볼륨 일련 번호만 범위 내에 있는 것으로 간주됩니다. 예를 들어, 1234-12356 범위는 잘못된 범위입니다. 1234-2345 범위에서 볼륨 일련 번호 123567은 범위 내에 있는 것으로 고려되지 않습니다. 지정된 범위가 유효한 경우 범위 내 일부 볼륨을 풀에 지정할 수 없더라도 데이터베이스에 추가됩니다. 지정된 볼륨 범위는 기존 볼륨 범위와 겹치지 않아야 하며 서로 겹치지 않아야 합니다.

볼륨 범위는 ACSLS 형식 volser 범위에 따라 평가됩니다.

  • 범위에 지정된 두 volser는 동일한 문자 수를 포함해야 합니다.

  • 범위에서 첫번째 volser 요소는 두번째 volser 요소보다 반드시 작아야 합니다.

  • 지정된 volser의 길이가 6자 미만이면 공백이 채워져서 6자로 맞춰진 것처럼 평가됩니다.

  • ASCII 조합 시퀀스를 사용해서 평가할 때 첫번째 volser 요소보다 반드시 크거나 같고 두번째 volser 요소보다 반드시 작거나 같은 volser만 범위에 포함됩니다. 예를 들어, volser 범위 123456-234567에는 volser 12345A가 포함됩니다.

지정된 범위가 유효하면 범위 내 일부 볼륨을 풀에 지정할 수 없더라도 pool_name 데이터베이스에 추가됩니다. 지정된 볼륨 범위는 기존 볼륨 범위와 겹치지 않아야 하며 서로 겹치지 않아야 합니다.

ADD

풀의 기존 범위에 지정된 볼륨 범위를 추가해야 함을 나타냅니다. 이 옵션은 기본값입니다. 지정된 경우 VOLumes도 지정해야 합니다. ADDREPLace와 상호 배타적입니다.

REPlace

지정된 볼륨 범위를 현재 지정된 볼륨 범위로 바꾸고, 이전 범위의 볼륨을 풀 0에 다시 지정해야 함을 나타냅니다. 지정된 경우 VOLumes(또는 VOLSer)도 지정해야 합니다. REPlaceADD와 상호 배타적입니다.

FORCE

선택적으로, 다른 풀에 이미 지정된 볼륨을 새 풀에 다시 지정해야 함을 나타냅니다. 이 매개변수가 지정되지 않은 경우 현재 다른 풀에 지정된 볼륨은 업데이트되지 않습니다. 지정된 경우 VOLumes(또는 VOLSer)도 지정해야 합니다.

APPLY

선택적으로, 이전에 정의된 볼륨 범위를 데이터베이스의 볼륨에 적용해야 함을 나타냅니다. 이 매개변수는 위에 나열된 제한 사항으로 인해 일부 볼륨이 업데이트되지 않았을 때 사용할 수 있습니다. 지정된 경우 VOLumes(또는 VOLSer)도 지정해야 합니다.

다음 예에서 명령은 DRL001-DRL999 볼륨을 SCRPOOL1에 추가합니다.

XCMD SET POOL_NAME SCRPOOL_TEST1 VOLUMES DRL001-DRL999

QUERY POOL_Name

다음 절에서는 QUERY POOL_Name 명령에 대해 설명합니다.

설명

QUERY POOL_Name 명령은 모든 풀, 지정된 문자로 시작하는 풀 또는 단일 풀을 표시합니다.

구문

다음 그림은 QUERY POOL_Name 명령의 구문을 보여줍니다.

그림 3-6 QUERY POOL_Name 명령 구문

주변 텍스트에서 그림 3-6 에 관해 설명합니다.

매개변수

그림 3-6에 표시된 것처럼 QUERY POOL_Name 명령에는 다음 매개변수가 포함됩니다.

pool_name

최대 13자의 기존 풀 이름 또는 마지막 별표('*') 문자가 있는 일반 이름입니다. 이 매개변수는 필수입니다.

pool_name 형식은 다음과 같이 출력 표시를 결정합니다.

  • pool_name이 일반이 아니면, 표시된 풀 정보에 일치하는 단일 풀에 대해 정의된 volser 및 volser 범위가 포함됩니다.

  • pool_name이 일반인 경우(후행 '*' 포함), 표시된 풀 정보에는 일치하는 풀에 대해 정의된 volser 및 volser 범위가 포함되지 않습니다.

다음 예에서 사용자는 QUERY POOL_Name 명령을 실행해서 연관된 볼륨 범위를 포함하여 pool1에 대한 정보를 표시합니다.

XCMD QUERY POOL_NAME POOL1

다음 예에서 사용자는 QUERY POOL_Name을 실행해서 이름 지정된 모든 풀에 대한 정보를 표시합니다(볼륨 범위 포함 안함).

XCMD QUERY POOL_NAME *

다음 예에서 사용자는 QUERY POOL_Name 명령을 실행해서 ”A”로 시작하는 모든 풀에 대한 정보를 표시합니다(볼륨 범위 포함 안함).

XCMD QUERY POOL_NAME A*

QUERY POOL_Access

다음 절에서는 QUERY POOL_Access 명령에 대해 설명합니다.

설명

QUERY POOL_Access 명령은 단일 호스트 또는 풀 이름과 연관된 모든 호스트에 대한 풀 액세스 규칙을 표시합니다.

구문

다음 그림은 QUERY POOL_Access 명령의 구문을 보여줍니다.

그림 3-7 QUERY POOL_Access 명령 구문

주변 텍스트에서 그림 3-7 에 관해 설명합니다.

매개변수

그림 3-7에 표시된 것처럼 QUERY POOL_Access 명령에는 다음 매개변수가 포함됩니다.

pool_name

최대 13자의 풀 이름. 풀 이름은 퍼센트 기호("%"), 밑줄("_") 또는 별표("*")를 제외한 모든 문자를 포함할 수 있습니다. 지정된 pool_nameDEFINE POOL_Name 명령을 사용해서 이전에 정의되어 있어야 합니다. 자세한 내용은 DEFINE POOL_Name을 참조하십시오.

HOSTid host_id

선택적으로, 1-31자의 host_name을 지정합니다. 지정된 host_idDEFINE_POOL_Access 명령을 사용해서 이전에 pool_name에 대해 정의되어 있어야 합니다. 자세한 내용은 DEFINE POOL_Access를 참조하십시오.

이 매개변수를 지정하지 않으면 풀과 연관된 모든 호스트에 대한 액세스 규칙이 표시됩니다.

다음 예에서 사용자는 QUERY POOL_Access 명령을 실행해서 pool_name SCRPOOL1과 연관된 모든 호스트에 대한 액세스 규칙을 질의합니다.

XCMD QUERY POOL_ACCESS SCRPOOL1