Using the YKSETENV command
License information dataset names are specified and formatted as follows:
prefix1.prefix2.CCENTRAL.LICENSE
A prefix of the license information dataset consists of prefix1 and prefix2. The length of each prefix is from 1 to 8 characters.
You can select one of the following two prefix specification methods:
- Specify a value for the Business Continuity Manager environment variable (YKLCNSE and YKLCNS2) with the YKSETENV command.
- Specify a value for the system symbol &YKLCNSE and &YKLCNS2 in the IEASYMxx parmlib member.
The following lists the priority for specified values, in descending order:
- value-specified-by-the-YKSETENV-command
- value-specified-for-the-IEASYMxx-parmlib-member
- default-value (HITACHI)
The method for specifying a value in the IEASYMxx parmlib member requires a re-IPL of the system. If a re-IPL cannot be executed because the system is running, use the YKSETENV command to specify a value.
Execute the YKSETENV command to set the Business Continuity Manager environment variables (YKLCNSE and YKLCNS2). For details about the format for the YKSETENV command, see section YKSETENV command format.
The following example names the license information dataset HTC1.BCM.CCENTRAL.LICENSE:
START YKSETENV,PARM='YKLCNSE=HTC1' START YKSETENV,PARM='YKLCNS2=BCM'
If YKLCNSE is omitted, the value of the &YKLCNSE system symbol is used. If YKLCNS2 is omitted, the value of the &YKLCNS2 system symbol is used. The YKLCNS2 value becomes valid when a value is specified in either YKLCNSE or &YKLCNSE.
- Add the YKSETENV command to the COMMNDxx parmlib member to set the Business Continuity Manager environment variables again automatically by re-IPL.
- Define the prefix value in the system symbol &YKLCNSE and &YKLCNS2 of the IEASYMxx parmlib member, and use this prefix value, which will be registered at the next IPL.
Defining a system symbol in the IEASYMxx parmlib member
Define the system symbol &YKLCNSE and &YKLCNS2 for the IEASYMxx parmlib member. After the definition, enable the setting by re-IPL of the host.
The following example names the license information dataset HTC1.BCM.CCENTRAL.LICENSE:
SYMDEF(&YKLCNSE='HTC1') SYMDEF(&YKLCNS2='BCM')
If &YKLCNSE is omitted, HITACHI is assumed. If &YKLCNS2 is omitted, only &YKLCNSE is used. &YKLCNS2 is valid only when &YKLCNSE has been specified.
The following table shows the relationship between the prefix of the license information dataset name and the specification status for the YKSETENV command or IEASYMxx parmlib member:
YKSETENV command |
IEASYMxx parmlib member |
Prefix |
||
|---|---|---|---|---|
YKLCNSE |
YKLCNS2 |
&YKLCNSE |
&YKLCNS2 |
|
Y |
Y |
Y |
Y |
YKLCNSE.YKLCNS2 |
Y |
Y |
Y |
-- |
YKLCNSE.YKLCNS2 |
Y |
Y |
-- |
Y |
YKLCNSE.YKLCNS2 |
Y |
-- |
Y |
Y |
YKLCNSE.&YKLCNS2 |
-- |
Y |
Y |
Y |
&YKLCNSE.YKLCNS2 |
Y |
Y |
-- |
-- |
YKLCNSE.YKLCNS2 |
Y |
-- |
Y |
-- |
YKLCNSE |
Y |
-- |
-- |
Y |
YKLCNSE |
-- |
Y |
Y |
-- |
&YKLCNSE.YKLCNS2 |
-- |
Y |
-- |
Y |
HITACHI |
-- |
-- |
Y |
Y |
&YKLCNSE.&YKLCNS2 |
Y |
-- |
-- |
-- |
YKLCNSE |
-- |
Y |
-- |
-- |
HITACHI |
-- |
-- |
Y |
-- |
&YKLCNSE |
-- |
-- |
-- |
Y |
HITACHI |
-- |
-- |
-- |
-- |
HITACHI |