Application Programming Interface › Using API Member Names › xtcerrincr

xtcerrincr

Specifies the transfer requests for which the xtchold_count parameter value is incremented if the current file transfer fails.

Up to eight transfer request names

Specifies up to eight transfers whose hold counts are to be incremented if the current file transfer fails.

Notes:

• A VTAM communications error does not count as a failure.
• If the current file transfer fails, the value of the xtchold_count parameter of the transfers assigned to this parameter is increased by one, unless the next transfer has already started or the xtchold_count value has already reached zero.

xtcerrpurge

This parameter specifies the transfer requests to be purged if the transfer concludes unsuccessfully.

Up to eight transfer request names

Specifies up to eight transfers to be purged if the current file transfer concludes unsuccessfully.

Note: xtcerrpurge overrides xtchold_count.

xtcerrrel

This parameter specifies the transfers to be released if the current transfer completes unsuccessfully.

Up to eight transfer request names

Specifies up to eight transfers to be released if the current transfer completes unsuccessfully.

Note: xtchold_count overrides xtcerrrel.

xtcgooddecr

This parameter indicates an xtcnet job whose hold count decrements if the file transfer completes successfully.

Up to eight transfer request names

Specifies up to eight transfers whose hold counts are to be decremented if the current transfer completes successfully.

Note: If the current file transfer completes successfully, the value of the xtchold_count parameter of the transfers assigned to this parameter is reduced by one, unless the next transfer has already started or the xtchold_count value has already reached zero.

xtcgoodincr

This parameter indicates the transfer requests whose xtchold_count parameter is incremented when the current file transfer completes successfully.

Up to eight transfer request names

Specifies up to eight transfers whose hold counts are to be incremented if a transfer completes successfully.

Note: If the current file transfer completes successfully, the value of the xtchold_count parameter of the transfers assigned to this parameter is increased by one, unless the next transfer has already started or the xtchold_count value has already reached zero.

xtcgoodpurge

This parameter specifies the transfer requests to be purged when the current file transfer completes successfully.

Up to eight transfer request names

Specifies up to eight jobs to be purged if a transfer completes successfully.

Note: xtcgoodpurge overrides xtchold_count.

xtcgoodrel

This parameter specifies the transfer requests to be released if the current file transfer concludes successfully.

Up to eight transfer request names

Specifies up to eight jobs to be released if a transfer completes successfully.

Note: xtchold_count overrides xtcgoodrel.

xtchold_count

This parameter associates a number with a transfer request that is incremented or decremented by the successful or unsuccessful completion of other transfer requests. As long as the number is greater than 0, the transfer is not released.

0 to 255

Specifies a value that controls the holding/releasing of a transfer request. The transfer is released when the value of the parameter reaches 0.

Note:

• See the description of the parameters xtcerrdecr, xtcerrincr, xtcgooddecr, and xtcgoodincr, which can decrement and increment the value of the xtchold_count parameter.
• hold_transfer=YES overrides xtchold_count.

xtcjob

This parameter defines the name of a transfer request belonging to the group of interdependent transfer requests named through the xtcnet parameter.

xxxxxxxx

Specifies the name of a transfer request in a group of interrelated transfer requests.

xtcnet

This parameter defines the name of a group of interdependent transfer requests.

xxxxxxxx

Specifies up to eight alphanumeric characters representing the name of the XTC network running this transfer.