Previous Topic: CA PanvaletNext Topic: CA Panvalet to CA Telon

Planning the Implementation › Group and Operation Personnel Decisions › Retrieve Processing Setup Decisions › CA Panvalet › Keyword Usage

Keyword Usage
LOCK

Set to the same value (Y or N) as the LOCK keyword through the keyword assignment statement in the Retrieve model specifications in the associated Library Code. A Y value generates a PAN#1 STEP to ++LOCK the From Member in the From Library when the From Library is QA or Production. The LOCK keyword must always be set to N for releases of CA‑Panvalet prior to 14.1.

$MEMBERCOUNT

Set to the current Retrieve request model execution count for the purpose of generating unique JCL field names such as STEP names. The character value ranges from 0000000 through 9999999 and is incremented by 1 for each member.

$CHKREP

Set to the same value (Y or N) as the Replace Member field of the Retrieve Processing Options panel. A value of Y indicates that the transferred CA‑Panvalet member can replace an existing member of the same name ($TONAME) in the TEST CA‑Panvalet Library ($DEST1DSN).

Note: Because the column 72 R option of the ++TRANSFER direct method causes the STATUS of the member in the destination library to be the same as the STATUS in the origin library, this method cannot be used. If the origin library member had a PROD STATUS, that would be carried to the destination library. Thus, the To Member must be deleted from the To Library so that the column 72 R option is not required.

To accomplish this with CA‑Panvalet, complete the following steps:

  1. CONDITIONALLY GENERATED: If the REPLACE (Retrieve) option is specified, you need From Member existence test. This step is used as a safeguard against deleting the requested member from the To Library when a From Member does not exist in the From Library. A STEP is generated to test whether the From Member exists in the From Library. If this step is not successful, the succeeding steps are not executed.
  2. CONDITIONALLY GENERATED: If the REPLACE option is specified, a PAN#2 STEP is generated to ++DELETE the existing To Member from the TEST Library.
  3. ALWAYS GENERATED: A PAN#2 STEP is always generated to ++TRANSFER the From Member in the From Library directly to the To Library using the From Member name.
$ORIGDSN

Set to the data set name that the member is being Retrieved from, as defined to the Library Code.

$DEST1DSN

Set to the target data set name.

$DEST1SEC

Set to the CA‑Panvalet Library Control Code for the Test Library defined in the associated Library Code.

$FROMNAME

Set to the same value as the From Member field of the Retrieve Processing Options panel. The $FROMNAME value is used in the CA‑Panvalet control statements to request the source library member.

$TONAME

Set to the same value as the To Member field of the Retrieve Processing Options panel. The $TONAME value is used in CA‑Panvalet control statements to request the target library member after the copy. It must be the same as $FROMNAME.