gtps1m2aSystem Macros

CYDNC-Cycle Down Utility CP Interface

Use this system macro to provide an interface between cycle down routines in CVCW and cycle down subroutines that reside in the control program (CP).

Format




label
A symbolic name may be assigned to the macro statement.

FUNCTION
This required parameter specifies which of the Cycle Down subroutines is to be invoked by this macro.

CLES
This option selects the routine that scans a selected CPU loop list to detect the presence of at least one ECB that is not related to IPC or MPIF internal processing.

ETES
This option selects the routine that scans the physical ECB table, searching for lost ECBs. These ECBs will be identified through a message and will otherwise be ignored. The cycle-down process will continue in spite of their presence in the TPF system.

ETCT
This option selects the routine that scans the physical ECB table to determine an accurate count of the non-system ECBs remaining in the subsystem in which the cycle ECB is running.

LIST=Rx
The register specified on this input parameter is expected to contain a CPU loop list equate value as defined in the CLHEQ macro. This parameter defines the 'dispatch list' which will be searched in this macro invocation. The register specified must be in the range R0-R7 or R14-R15.

The parameter is required for the CLES function and is otherwise ignored.

RETURN=Ry
The register specified on this output parameter will contain a value indicating the results of the function. The register specified must be in the range R0-R7 or R14-R15. The exact meaning is unique to each function:

When FUNCTION=CLES, a value of zero indicates that no ECBs for the calling ECB subsystem were found on the requested dispatch list which satisfied the remaining selection criteria. A value of one indicates that at least one such ECB was found.

When FUNCTION=ETES, the parameter is ignored.

When FUNCTION=ETCT, the value returned is the count of non-system ECB in the subsystem.

DSECT
Optional parameter that may be used to request the generation of a DSECT that describes the parameter list generated by the normal CYDNC macro expansion. The use of this parameter should be limited to the CYDNC service routines.

YES
A DSECT describing the parameters to be passed to the SVC service routine is generated.

NO
The normal macro expansion is generated (an SVC for IBM vectored SVC processing, the second level SVC (index) number, and parameters being passed to the SVC service routine). The default is DSECT=NO.

Entry Requirements

The register specified by the LIST= parameter must contain a CLH List value as noted above (for the CLES function only).

Return Conditions

Programming Considerations

Examples

None.