Configuration Parameters › CONFIG Member Parameters › RCALPROC

RCALPROC

Specifies the name of an external procedure that will be used for the recall of archived data sets.

xxxxxxxx

Specifies the one- to eight-character name of the recall procedure.

Default: None

Notes:

• If no RCALPROC is specified, then CA XCOM Data Transport will allow the local archive product to recall the data set during dynamic allocation (SVC99). In some cases dynamic allocation may acquire an enqueue on the system resource SYSZTIOT and hold the enqueue until the data set has been recalled.
• With a RCALPROC specified, CA XCOM Data Transport will request that dynamic allocation not recall the data set but instead return a code that indicates that the data set has been archived.

  When CA XCOM Data Transport receives the code from dynamic allocation that the data set has been archived, the following occurs:

  • The transfer is suspended.
  • The recall processing will be done outside of the CA XCOM Data Transport server's region using a START command. RCALPROC is used to define the name of the procedure (commonly called a proc) that is used to recall the data set.
  • The retry of the transfer is controlled by the ERRINTV parameter.

Example

If RCALPROC=XCOMRCAL is defined, then the XCOMRCAL procedure should be coded as follows to recall the data set:

//XCOMRCAL PROC XDSN=
//*===========================================================*
//BR14    EXEC  PGM=IEFBR14
//*===========================================================*
//RCALDS   DD  DISP=SHR,DSN=&XDSN
//         PEND

The parameter XDSN will be set to the name of the archived data set.

• We recommend that users take note of the time it takes to recall their migrated or archived data sets and use the higher end of the recall time as the ERRINTV value in the CA XCOM Data Transport default table if the RCALPROC is coded. If the recall time is much higher than the normal ERRINTV currently in use, then we suggest that you set up a separate CA XCOM Data Transport server to do transfers of data sets that are regularly migrated or archived to tape so you can set the ERRINTV value to that of the recall time without affecting the performance of your regular transfers.
• RCALPROC is not supported on the XCOMPLEX Admin Server.