Preparation work
Allocate the following CSV files to be input by YKIMPORT, and add copy pairs and CTG information to each copy group.
For details about the CSV files to be input by YKIMPORT, see "CSV files used by the copy group definition file generation function" in the Hitachi Business Continuity Manager Reference Guide.
Type of CSV file |
Name of the dataset to be allocated |
|
---|---|---|
For the TrueCopy copy group CGTC01 |
For the Universal Replicator copy group CGUR01 |
|
Pair information CSV file |
USERID.CGTC01.PAIR.CSV |
USERID.CGUR01.PAIR.CSV |
CTG information CSV file |
-- |
USERID.CG.CTGUR01.CSV |
Creating a TrueCopy copy group definition file (YKDEFGRP)
First, define the TrueCopy copy group CGTC01.
- Example of a request line
-
PUT https://IP-address-of-the-z/OSMF-server/zosmf/tsoApp/app/USERID-38-aabcaaaf/YKAPI
- Example of a request body
-
For the cliname key value, specify YKDEFGRP. For the CLIPARMS key value array, specify information about the copy group to be defined.
-
{"cliname":"YKDEFGRP", "CLIPARMS":[ "PREFIX USERID.PREFIX", "DAD LOCAL", "GROUP CGTC01", "DESCRIPTION TC copy group", "PRIDAD LOCAL", "SECDAD MID", "PRISCHSET 0", "SECSCHSET 0", "COPYTYPE TC", "COPYPACE NORMAL", "PROTECTMODE PROTECT" ] }
-
The PREFIX and DAD parameters can be omitted because their values are the same as those of the default parameters.
Creating a Universal Replicator copy group definition file (YKDEFGRP)
Next, define the Universal Replicator copy group CGUR01.
- Request body
-
For the cliname key value, specify YKDEFGRP. For the CLIPARMS key value array, specify information about the copy group to be defined.
-
{"cliname":"YKDEFGRP", "CLIPARMS":[ "PREFIX USERID.PREFIX", "DAD LOCAL", "GROUP CGUR01", "DESCRIPTION UR copy group", "PRIDAD MID", "SECDAD REMOTE", "PRISCHSET 0", "SECSCHSET 0", "COPYTYPE UR", "COPYPACE NORMAL", "PROTECTMODE PROTECT", "CTTIMEMODE ASIS", "ERRORLEVEL GROUP", "MIRRORID 1" ] }
-
The PREFIX and DAD parameters can be omitted because their values are the same as those of the default parameters.
Adding the TrueCopy copy pair definitions to the copy group definition file (YKIMPORT)
First, add copy pairs to the TrueCopy copy group CGTC01.
- Request body
-
For the cliname key, specify YKIMPORT. For the operands key, specify the parameters of YKIMPORT. For the INPAIR parameter, specify the pair information CSV file (USERID.CGTC01.PAIR.CSV) created in the preparation work.
-
{"cliname":"YKIMPORT", "operands":"BASEGROUP(CGTC01) NEWGROUP(CGTC01) PREFIX(USERID.PREFIX) INPAIR('USERID.CGTC01.PAIR.CSV')" }
-
The PREFIX parameter can be omitted because its value is the same as that of the default parameter.
- Example of a response body
-
{"servletKey":"USERID-38-aabcaaaf","ver":"0100", "appData":{"bcmVer":"099100", "vendor":"Hitachi Vantara, Ltd.", "rc":0, "bcmMsg":[], "action":"submit", "cliname":" YKIMPORT", "operands":"BASEGROUP(CGTC01) NEWGROUP(CGTC01) PREFIX(USERID.PREFIX) INPAIR('USERID.CGTC01.PAIR.CSV')"}, "reused":false, "timeout":false}
Adding the Universal Replicator copy pair definitions and CTG definition to the copy group definition file (YKIMPORT)
Next, add copy pairs to the Universal Replicator copy group CGUR01.
- Example of a request line
-
PUT https://IP-address-of-the-z/OSMF-server/zosmf/tsoApp/app/USERID-38-aabcaaaf/YKAPI
- Example of a request body
-
For the cliname key, specify YKIMPORT. For the operands key, specify the parameters of YKIMPORT. For the INPAIR parameter, specify the pair information CSV file (USERID.CGUR01.PAIR.CSV) created in the preparation work. For the INCTG parameter, specify the CTG information CSV file (USERID.CG.CTGUR01.CSV).
-
{"cliname":"YKIMPORT", "operands":"BASEGROUP(CGUR01) NEWGROUP(CGUR01) PREFIX(USERID.PREFIX) INPAIR('USERID.CGUR01.PAIR.CSV') INCTG('USERID.CG.CTGUR01.CSV')" }
-
The PREFIX parameter can be omitted because its value is the same as that of the default parameter.
- Example of a response body
-
{"servletKey":"USERID-38-aabcaaaf","ver":"0100", "appData":{"bcmVer":"099100", "vendor":"Hitachi Vantara, Ltd.", "rc":0, "bcmMsg":[], "action":"submit", "cliname":" YKIMPORT", "operands":"BASEGROUP(CGUR01) NEWGROUP(CGUR01) PREFIX(USERID.PREFIX) INPAIR('USERID.CGUR01.PAIR.CSV') INCTG('USERID.CG.CTGUR01.CSV')"},"
Loading the TrueCopy copy group definition file (YKLOAD)
First, load the definition file for the TrueCopy copy group CGTC01.
- Request body
-
For the cliname key, specify YKLOAD. For the operands key, specify the parameters of YKLOAD.
-
{"cliname":"YKLOAD", "operands": "GROUP(CGTC01) PREFIX(USERID.PREFIX) DAD(LOCAL)" }
-
The PREFIX and DAD parameters can be omitted because their values are the same as those of the default parameters.
-
Tip:
If you load and check the copy group definition file before running YKIMPORT (when the copy group has no copy pair definition), instead of YKLOAD, run YKGETGRP with LOADGROUP(FORCE) specified for the operands key value.
Loading the Universal Replicator copy group definition file (YKLOAD)
Next, load the definition file for the Universal Replicator copy group CGUR01.
- Request body
-
For the cliname key, specify YKLOAD. For the operands key, specify the parameters of YKLOAD.
-
{"cliname":"YKLOAD", "operands": "GROUP(CGUR01) PREFIX(USERID.PREFIX) DAD(LOCAL)" }
-
The PREFIX and DAD parameters can be omitted because their values are the same as those of the default parameters.
Checking the content of the TrueCopy copy group definition file (YKGETGRP)
First, check the content of the definition file for the TrueCopy copy group CGTC01.
- Example of a request line
-
PUT https://IP-address-of-the-z/OSMF-server/zosmf/tsoApp/app/USERID-38-aabcaaaf/YKAPI
- Example of a request body
-
For the cliname key, specify YKGETGRP. For the operands key, specify the parameters of YKGETGRP.
-
{"cliname":"YKGETGRP", "operands":"GROUP(CGTC01) PREFIX(USERID.PREFIX) " }
-
The PREFIX parameter can be omitted because its value is the same as that of the default parameter.
- Response body
-
{"servletKey":"USERID-38-aabcaaaf","ver":"0100", "appData":{"bcmVer":"099100", "vendor":"Hitachi Vantara, Ltd.", "rc":0, "action":"submit", "bcmMsg":[], "cliname":"YKGETGRP", "operands":"GROUP(CGTC01) PREFIX(USERID.PREFIX)", "prefix":"USERID.PREFIX", "copyGroup":{ "ID":"CGTC01", "description":"TC copy group","copyType":"TC", "primaryDADID":"LOCAL", "secondaryDADID":"MID", "pairCt":3, "primarySCHSET":"0","secondarySCHSET":"0", "groupCt":"1", "InitPace":"NORMAL", "protectMode":"PROTECT", "freezeScpMode":"N","timeStampMode":"N","linkageOption":"NONE", "fenceLevel":"NEVER","map":"TRK","openMF":"N" },"CTGroup":[ { "groupIndex":1, "pairCt":"3", "pair":[ { "pairIndex":1, "pri":{ "devn":"1130", "serialNum":"11111", "CUNum":"11", "SSID":"1111", "CCA":"30", "IFType":"4040","model":"VSPG1000"}, "sec":{ "devn":"2230", "serialNum":"22222", "CUNum":"22", "SSID":"2211", "CCA":"30", "IFType":"4040","model":"VSPG1000"} }, { "pairIndex":2, "pri":{ "devn":"1131", "serialNum":"11111", "CUNum":"11", "SSID":"1111", "CCA":"31", "IFType":"4040","model":"VSPG1000"}, "sec":{ "devn":"2231", "serialNum":"22222", "CUNum":"22", "SSID":"2211", "CCA":"31", "IFType":"4040","model":"VSPG1000"} }, { "pairIndex":3, "pri":{ "devn":"1132", "serialNum":"11111", "CUNum":"11", "SSID":"1111", "CCA":"32", "IFType":"4040","model":"VSPG1000"}, "sec":{ "devn":"2232", "serialNum":"22222", "CUNum":"22", "SSID":"2211", "CCA":"32", "IFType":"4040","model":"VSPG1000"} } ] } ] } } }, "reused":false, "timeout":false}
Checking the content of the Universal Replicator copy group definition file (YKGETGRP)
Next, check the content of the definition file for the Universal Replicator copy group CGUR01.
- Request body
-
For cliname key, specify YKGETGRP. For the operands key, specify the parameters of YKGETGRP.
-
{"cliname":"YKGETGRP", "operands":"GROUP(CGUR01) PREFIX(USERID.PREFIX) " }
-
The PREFIX parameter can be omitted because its value is the same as that of the default parameter.
- Response body
-
{"servletKey":"USERID-38-aabcaaaf","ver":"0100", "appData":{"bcmVer":"099100", "vendor":"Hitachi Vantara, Ltd.", "rc":0, "bcmMsg":[], "action":"submit", "cliname":" YKGETGRP", "operands":" GROUP(CGUR01) PREFIX(USERID.PREFIX)", "prefix":"USERID.PREFIX", "copyGroup":{ "ID":" CGUR01", "description":"UR copy group","copyType":"UR", "primaryDADID":"MID", "secondaryDADID":"REMOTE", "pairCt":3, "primarySCHSET":"0","secondarySCHSET":"0", "groupCt":"1", "InitPace":"NORMAL", "protectMode":"PROTECT", "mirrorID":"1", "errorLevel":"GROUP", "CTTimeMode":"ASIS", "pathID":"00", "exctgEnable":"false" },"CTGroup":[ { "groupIndex":1, "CTGroupID":"11", "subCTGroupID":"21", "pairCt":"3", "pair":[ { "pairIndex":1, "pri":{ "devn":"2230", "serialNum":"22222", "CUNum":"22", "SSID":"2211", "CCA":"30", "IFType":"4040","model":"VSPG1000" }, "sec":{ "devn":"3330", "serialNum":"33333", "CUNum":"33", "SSID":"3311", "CCA":"30", "IFType":"4040","model":"VSPG1000" } }, { "pairIndex":2, "pri":{ "devn":"2231", "serialNum":"22222", "CUNum":"22", "SSID":"2211", "CCA":"31", "IFType":"4040","model":"VSPG1000" }, "sec":{ "devn":"3331", "serialNum":"33333", "CUNum":"33", "SSID":"3311", "CCA":"31", "IFType":"4040","model":"VSPG1000" } }, { "pairIndex":3, "pri":{ "devn":"2232", "serialNum":"22222", "CUNum":"22", "SSID":"2211", "CCA":"32", "IFType":"4040","model":"VSPG1000" }, "sec":{ "devn":"3332", "serialNum":"33333", "CUNum":"33", "SSID":"3311", "CCA":"32", "IFType":"4040","model":"VSPG1000" } }, ] } ] } } }, "reused":false, "timeout":false}