Cyclic transfer requests

A cyclic transfer request is a periodic, repeated transfer request. The period, the time between 2 transfer activation cycles, is defined by the CYCLE and TCYCLE parameters.

  • CYCLE: Numeric value of TCYCLE.
  • TCYCLE: The type of period, expressed in minutes (MIN), days (DAY), or months (MONTH).

The overall time frame for this request is defined by the MINDATE/MINTIME and MAXDATE/MAXTIME parameters, and corresponds to the global time during which the transfers are periodically repeated.

The time slot for activating each basic transfer is defined by the MINDATE/MINTIME and CYCDATE/CYCTIME parameters, where:

  • CYCDATE: End date for activating the first transfer of a cycle.
  • CYCTIME: End time for activating the first transfer of a cycle.

The start times/dates and cycle duration values are expressed in the following equation:

CYCLE * TCYCLE >= (CYCDATE,CYCTIME) - (MINDATE,MINTIME)

Example

The example command creates a cyclic transfer request as described and illustrated below:

SEND PART=PARIS, MINDATE=20150703, MINTIME=1000, MAXDATE=20151231, MAXTIME=1000, CYCLE=7, TCYCLE=DAY, CYCDATE=20150705, CYCTIME=1000
  • The request start date and time is July 3, 2015 at 10:00 (MINDATE/MINTIME).
  • A period of inactivity begins on July 5, 2015 at 10:00 (CYCDATE/CYCTIME).
    • A child transfer of the cyclic request who's execution began during the period of activity will complete, even that time extends into the period of inactivity.
    • Any child transfer of the generic request that were not executed before this period of inactivity will be lost.
  • The cycle duration is 7 days (CYCLE/TCYCLE), so activity restarts on July 10, 2015.
  • This pattern repeats itself until the defined end date and time (MAXDATE/MAXTIME).

A cyclic transfer request results in the creation of a generic virtual transfer entry for the actual transfers. This generic entry is maintained in the transfer catalog and gives rise, for each new cycle, to a real transfer. The generic entry is purged at the end of the last cycle, when MAXDATE is exceeded.

A generic entry is characterized by one of the values indicated in the table below, for the DIAGP field, at the time the catalog is queried (LISTCAT CONTENT=BRIEF).

Generic entry values

Diagp value 

Cycle 

MIN CYC 

Cycle expressed in minutes 

DAY CYC 

Cycle expressed in days 

MON CYC 

Cycle expressed in months 

Use the CONTENT=FULL option to view all of the parameters for this cyclic request.

See also, CYCLE, CYCTIME, CYCDATE, TCYCLE.

Related Links